.TH E1432_GET_CVT_DATA 3 E1432
.SH NAME
.nf
e1432_get_cvt_data \- Read order current value table
.fi
.IX e1432_get_cvt_data(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_get_cvt_data(E1432ID hw, SHORTSIZ16 ID,
                              FLOATSIZ32 *buffer, LONGSIZ32 points)
.cE
.SH DESCRIPTION
This function applies only the the E1432 option 204 firmware.

\fIe1432_get_cvt_data\fR returns a block of order data into
\fIbuffer\fR.  The current value table reflects the latest averaged
order calculation.  The E143x firmware is prevented from modifying
this table during the transfer process to the host, so the data is
synchronized across all channels.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the hardware
to talk to.

\fIID\fR is the ID of a group or single channel.

\fIbuffer\fR is a pointer to the array for returned data.  The size of
\fIbuffer\fR must be at least:

   \fIpoints\fR  * the number channels in \fIID\fR * sizeof(FLOATSIZ32)

in bytes, or the function will overrun \fIbuffer\fR.

\fIpoints\fR is the number of values wanted for each channel in
\fIID\fR.  If the order data is complex, then there will be
\fIpoints\fR/2 complex values stored in the buffer for each channel.
If the order data is real, then there will be \fIpoints\fR real values
stored in the buffer for each channel.

These order data will be either real or complex depending on the
averaging mode.  When the averaging modes is RMS, PEAK, or
EXPONENTIAL, the order data is real.  For all other averaging modes,
the order data is complex, the real part followed by the imaginary
part.

The maximum valid value for \fIpoints\fR is
\fBE1432_ORDER_CVT_SIZE\fR*2.  Values larger than this are silently
rounded down to this value.

In addition, there are only \fImax_order\fR / \fIdelta_order\fR + 1
useful order values available for each channel.  So the value of
\fIpoints\fR should be no more than that for real order data, or no
more than twice that for complex data.  Attempts to get more data than
that will get garbage data after the end of the valid data.

.SH "RESET VALUE"
Not applicable.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
e1432_set_avg_mode
